
╔═════════╦════════════════════════════════════════════════════════════
║ GT-HELP ║ GT.CNF - GT's main Configuration File
╚═════════╩════════════════════════════════════════════════════════════


    In most cases, the GT configuration file GT.CNF is best edited by the
    ALT-I command within GT.  This shows each of the entries against an
    appropriate caption.

    Three possible exceptions are :

        a)  Paths       If you used the GT-INST.BAT procedure, it will have
                        created paths (and the directories to go with them)
                        which should be suitable for your initial testing.

        b)  Modems      If your modem is defined in the GT-Help Modem
                        Library, you can conveniently select all the
                        associated parameters from the GT-Help menu option.

                        Note: You will still have to specify the com port
                        address if it is not COM1.

        c)  Colours     GT-Help provides a more interactive method of
                        configuring colour parameters.


    For first time use, you should check in particular the COM Port
    settings (probably COM1 8 N 1).

    If you need to edit other parameters manually, you may do so.  For
    convenience, the parameters are reproduced from the GT15HOST.DOC,
    except that I have classified them under related headings.


┌───────────────┐
│ Port Settings │
└───────────────┘

     CM= COM port number, 1,2,3 or 4.
     ST= Number of Stopbits.
     DA= Number of Databits.
     PA= Parity. 0=None,1=Even,2=Odd


┌───────┐
│ Paths │
└───────┘

     DP= Directory PATH.  This variable tells the program where to look for
            the  phone  directory.  This  parameter  is provided mainly for
            people who wish to put the dialing directory on a RAM-disk.

     TP= Download PATH.  All files received by GT are placed,  by  default,
            in this directory.  User may override, by typing full pathnames 
            when entering filenames.  Effects host mode operation also!  

     UP= Upload PATH.  Does not apply to host mode operation.

     SP= Script PATH.  Scripts are stored in this directory.

     CP= Capture PATH.  Capture saves are done to this directory.

     MP= Message  base  PATH.  Controls where GT will place the *.CTL files
            and the GTMSGS sub-directory.  

     PD= Current phone directory name.  Default is 'GT'.

     KY= Name of the current macro key file.  Default is 'GT'.

     SM= Message path for M)essages to the SYSOP.

     DD= The default file directory.  The one callers first see  when  they
            connect.  

     LO= Log file path.  The log will be stored in this directory.


┌───────┐
│ Modem │
└───────┘

These values can also be set via the GT-Help Modem Library.

Note :  if you select a modem from the GT-Help library and subsequently
        examine the GT.CNF file without first changing anything by ALT-I
        in GT, you will find GT.CNF contains the "old" definitions as
        well as the new.  This is not a problem, since GT uses the last
        definition it sees.

        You might find this confusing - but all you need to do is to change
        one parameter via ALT-I in order to save a "tidy" copy of the file.

     BA= Default Baud Rate. 300,1200,2400,4800,9600 or 19200.

     MB= Maximum Baud Rate.  Restricts values found in Phone Directory.

     CS= Honor CTS from modem option.

     S2= String to set modem to 300 baud.            }******
     S4= String to set modem to 1200 baud.           }
     S5= String to set modem to 2400 baud.           }
     S6= String to set modem to 4800 baud.           }
     S7= String to set modem to 9600 baud.           }
     S8= String to set modem to 19200 baud.          } For non-Hayes
     P0= String to set modem to 7 bits, no parity.   } modems only.  See
     P1= String to set modem to 7 bits, even parity. } table on page 56.
     P2= String to set modem to 7 bits, odd parity.  }
     P3= String to set modem to 8 bits, no parity.   }
     P4= String to set modem to 8 bits, even parity. }
     P5= String to set modem to 8 bits, odd parity.  }
     P6= String to set modem to 7 bits, mark parity. }
     P7= String to set modem to 8 bits, mark parity. }******

     PR= Dialing Pre String.

     PO= Dialing Post String,  use  the  |  character  where  a  Return  is
            required.  

     HU= The modem hang-up string.

     MI= Modem  initialization  string.  Use the | character where a Return
            is needed.  

     HO= Host mode, modem initialization string.

     AS= Answer string.  When issued, this string should cause the modem to
            answer an incoming call.  

     SY= Modem command string to turn the speaker ON.
     SN= Modem command string to turn the speaker OFF.

     FC= Forced Carrier.  Some modems force carrier even when a call is not
            in progress, if this is the case, set this parameter to TRUE.  

     RC= Result  codes.  The  code  is  defined by the numeric code and the
            code actually returned by the  modem.  There  are  17  possible 
            codes, only 15 of which are used.  Example: RC=1,CONNECT 

     HN= Off-hook string.  Sent to modem to make it go off-hook.
     HY= On-hook string.  Sent to modem to make it go on-hook.


┌──────────────────┐
│ User Preferences │
└──────────────────┘

     PF= Phone number prefix/suffix.  Associated with the  -  character.
     P+= Phone number prefix/suffix.  Associated with the  +  character.
     P*= Phone number prefix/suffix.  Associated with the  *  character.
     P!= Phone number prefix/suffix.  Associated with the  !  character.
     P&= Phone number prefix/suffix.  Associated with the  &  character.
     P?= Phone number prefix/suffix.  Associated with the  ?  character.

     RT= After carrier timeout has  occurred,  this  is  the  time  between
            redial, in seconds.  


     CT= Timeout time for carrier to appear, in seconds.

         Note:  You should *never* set this to a value lower than the
                carrier timeout of your modem, plus the time which your
                modem takes to dial a call.  It is best set to a LONG
                value, eg 100 seconds.

     E0= External protocol definition #1.
     E1= External protocol definition #2.
     E2= External protocol definition #3.
     E3= External protocol definition #4.
     E4= External protocol definition #5.
     E5= External protocol definition #6.
     E6= External protocol definition #7.
     E7= External protocol definition #8.
     E8= External protocol definition #9.
     E9= External protocol definition #10.


┌─────────┐
│ Colours │
└─────────┘

Note:   These values can most conveniently be set using the option in the
        main GT-Help menu.

     FG= The  default foreground colour number.  Any one of the 16 values in
            the table below.  
     BG= The default background colour number.  Any one of the DARK  shades,
            0-7, from the table below.  

     WF= Window  foreground colour number.  Anyone of the 16 values from the
            table below.  
     WB= Window background colour number.  Anyone of the DARK shades, 0-7,
            from the table below.

     WR= Window-frame foreground colour number.  Anyone  of  the  16  values
            from the table below.  
     WS= Window-frame  background  colour number.  Anyone of the DARK shades
            from the table below.  

     HF= Option hi-lite colour, foreground.
     HB= Option hi-lite colour, background.

     OF= Option lo-lite colour, foreground.
     OB= Option lo-lite colour, background.

     TF= Status line colour, foreground.
     TB= Status line colour, background.

     WU= Window Title colour, foreground.
     WV= Window Title colour, background.

     DU= Phone directory hi-lite colour, foreground.
     DV= Phone directory hi-lite colour, background.

     CR= Chat foreground.  For remote caller.
     CF= Chat foreground.  For local sysop.

The 'table below' (?) referred to above (!) is of course in GT15HOST.DOC.


┌─────────┐
│ General │
└─────────┘

     SR= Stripping option.  Strip parity bit from serial port input.

     XO= The decimal value of the XON character.  Used to control data flow
            Starts data flow after XOFF has been issued.  
     XF= The  decimal  value  of  the XOFF character.  Used to control data 
            flow Stops data flow when  issued.  Helps  insure  that  buffer 
            overflow does not occur.  

     VT= If TRUE,  turns on VT100 emulation,  using ANSI escape  codes.  If
            VT100  emulation  is requested,  music will not be played,  and 
            will show on the screen as text.  This  happens  because  of  a 
            conflict  between  the  full  ANSI  definition  and the musical 
            notes.  This does not  pose  a  problem  for  most  BBS  users, 
            because  they  do not need the full ANSI emulation.  BBS's that 
            send music and graphics use IBM ANSI  graphics,  which  can  be 
            processed without setting VT=TRUE.  For BBS use, this parameter 
            should  be  set  FALSE,  and  the  IBM  ANSI  graphics  will be 
            processed.  

     AW= Auto line wrap mode.  If  FALSE,  characters  received  while  the
            cursor  is in column 80 of the screen will not wrap to the next 
            line.  

     LF= Auto  Linefeed  mode.   If  TRUE,   then  a   linefeed   will   be
            automatically supplied whenever a carriage return is received.  

     MX= Number  of  Xmodem  buffers  to  allocate.  4  - 255 are the legal
            values.  A smaller number should be used on systems  with  only 
            128k,  larger  values  can be used if more memory is available.  
            Each buffer takes 128 bytes.  

     DM= DMA  mode.  Some  computers have no DMA chip,  some have defective
            DMA chips.  If you have one of these computer,  you will obtain 
            better results with file transfers, if this parameter is set to 
            SLOW.  If you have a normal IBM PC with good DMA chip, set this 
            parameter to FAST.  

     PC= The Pacing Character.  This is the character echoed by the host at
            the  end of each line.  If you set this character,  the program 
            will wait for it to be echoed by the host at the  end  of  each 
            line  during  an  ASCII  file  transmission.  The default is no 
            Pacing Character.  The abbreviations CR and LF may be  used  in 
            this  field  to  indicate  the  carriage  return  and  linefeed 
            characters, as well as the | character for carriage return.  

     EL= End-of-Line Mode.  This determines the line terminating characters
            sent  to the host,  during ASCII file transmit,  to delimit the 
            end-of-line.  Defaults to CRLF,  carriage return and  linefeed.  
            The other options are LF,  only linefeed, and CR, only carriage 
            return.  

     AD= ASCII  inter-character  delay.  Specified  in  milliseconds.   The
            default value is 0.  

     CC= The comment character used with the macro keys.

     SO= Bios video routines.  If TRUE,  the Bios video  routines  will  be
            used  my  the window handler,  instead of direct memory access.  
            The Bios routines are much slower,  but  have  the  benefit  of 
            compatibility with multi-tasking operating systems.  

     PG= Pagination of printer output.  If TRUE,  the output on the printer
            will  be  paginated,   so  that  it  doesn't   print   on   the 
            perforations.  

     LP= Lines per page.  Works with the pagination option.

     NK= Option to make NO KILL the default message security.

     CL= Capture memory buffer limit in 1,000s of characters.

     AR= Auto  redial  on  BUSY  result  from  modem.  If  TRUE,  GT's will
            automatically redial a number that is BUSY when dialed from the 
            phone directory.  

     SB= Minutes  of  inactivity until the screen is blanked.  A value of 0
            disables the screen blanker.  

     CK= If TRUE,  GT will automatically check diskspace available prior to
            downloading  any  file.  If FALSE,  GT will not check diskspace 
            before downloads.  

     MM= If FALSE,  GT will not play music received from the  host  system.
            If TRUE,  the music will be played.  If emulation mode is TRUE, 
            this switch is forced to be FALSE.  

     BS= Swap  position  of  BackSpace  and  Del  keys,  used  with  VT-100
            emulation.  

     BL= BREAK length in milliseconds.

     TL= Tilde  length.  The tilde ~ is used to add delay to various string
            sent to the modem.  

     CC= The comment character used with the macro keys.

     WN= Suppress window noise.  Do you want video game whistling windows?

     LG= If TRUE,  GT will keep  a  log  of  all  BBS's  called  and  files
            transferred.  Default is FALSE.  

     BP= Blank  pad  mode.  Used  to control the sending of blanks lines in
            ASCII transmit mode.  If TRUE,  then blank lines will be padded 
            with blanks.  Helps with message upload to BBSs.  

     EW= Exploding windows option.  If TRUE, then GT's windows will explode
            when they open.  


